3D

Introducción

The purpose of this manual is to instruct the user in the use of the new 3D extension for gvSIG. It is intended here to give an exhaustive and systematic description of the functionalities that the 3D plugging has.


Resumen de funcionalidades.

The functionality of the 3D extension can be subdivided into two groups: on one hand new elements that have been added to the gvSIG user interface and on the other elements that were already present in gvSIG but that have been adapted to function from within the 3D extension in a transparent manner to the user.

The elements shown next are kept the same, although in many cases there have been small modifications done to their codes so they can work in the 2D view as well as in the 3D view (see architecture section).


Vistas 3D

Introducción

The 3D extension for gvSIG adds a new type of document called 3D View. In many ways, this new type of document behaves as the normal views.


Crear una vista 3D

Once the 3D extension is installed in the gvSIG Project Manager, two new types of documents will show up, 3D View and Animation. All the options of the Project Manager can be applied to these types of documents: create a document, open, rename, delete and show properties. To create a new view, simply click on the button “New”.

In this section the “3D View” document will be explained

images/gestor-proyectos3d-es.png

Project Manager

It is possible to create multiple 3D views and to work simultaneously with the other types of gvSIG documents: 2D views, tables and maps.


Propiedades de la vista 3D

The 3D view is different from the normal 2D in that some of the properties must be initially specified and cannot be change later on. Because of that, once a 3D view is open for the first time (by clicking on the “Open” button of the Project Manager or double-clicking on the view’s name) the properties window of the 3D view will pop-up open.

images/propiedades3d-es.png

Properties of a 3D view

Spherical and Planar Views

In the properties window there is a property, proper to the 3D view that specifies if the view is of the planar or spherical type. This property is defined at the moment of opening the view for the first time and it cannot be change posteriorly. In a spherical view the data is visualised over a planetary ellipsoid, whereas in the planar view the geographical coordinates are visualised over the XY plane and the elevation along the Z axis.

In the planar 3D view it is possible to define the coordinate system. If we click in the button labelled as “Current Projection”, it will be possible to select the projection we would like for the planar 3D view. On the other hand if we select the spherical or planetary view, the view will have by default the coordinate system WGS84 (projection 4326).

Vertical Exaggeration

Another of the properties specific to the 3D view is the vertical exaggeration factor. The elevation values will be multiplied by that factor at the moment of performing the visualisation, so that the elevation values stand out more or less. This value can be changed any time.

Background colour

In the case of the 3D view the background colour is applied to the background space where the planetary globe or planar view is visualised. This value can be changed any time.


Herramientas de navegación

In the gvSIG 3D plugging offers simple navigation tools. When the 3D view is active, the navigation tools can be found in the application tool bar or in the View menu.

images/controles-navegacion-es.png

Navigation Controls

These tools function the same way in the spheric and planar views.

Displacement / panning

images/barra-desplazamiento-es.png

This tools allows the user to displace the anchor point over the terrain surface or in other words, to move the surface in the 3D view.

Altitude control / zoom

images/barra-zoom-es.png

Once this tools is active, the user could change the altitude with respect to the anchor point in the surface, by left-clicking and dragging the mouse up and down. This effect is more or less similar to the zoom in the 2D view.

Azimuth and inclination control (tilt and rotate)

images/barra-inclinacion-es.png

When this tool is activated, the user can pivot around the anchor point over the surface. The horizontal displacements with the mouse control the azimuth (if the North-up orientation mode is not active) and the vertical displacements control the inclination.

Combined navigation

images/navegacion-combinada-es.png

When this tool is selected, which is in fact the default active navigation tool, the three previous actions can be combined as follows:

North-up orientation mode

images/barra-siempre-norte-es.png

When this mode is active (the red line disappears in the icon) the view is always oriented with the geographic North at the top of the view. This allows, for example to displace or pan without loosing the orientation.

Full Extent

images/barra-zoom-completo-es.png

When this tools is activated, the view will show the entire geographic space or globe.


Gestión de encuadres

The Bookmark Manager Tool encuadres can be found in the tool bar and also in the View menu. Once this tool is activated it will open the Bookmark which is identical to the open used in the normal (2D) views.

By using this manager, actual positions within the 3D view can be saved with names and can be retrieved to be used within the same 3D view or others views defined within the project. These bookmarks however, are kept separate from those saved from within the 2D views.


Salvar y recuperar Vistas 3D

To save the content of the 3D views simply use the menu option File/Save Project or the corresponding tool in the toolbar. When the project is saved in a .gvp file all the properties corresponding to 3D view are stored in that project file. In the project it is also saved the bookmarks list defined for the 3D view which could be used in posterior sessions.

To retrieve a project where there are saved 3D views, it is only necessary to use the File/Open Project menu or the corresponding tool. The 3D views will be restored to the position in which they were saved, including the layers and extent.


Pantalla Completa

The tool to set full completa screen can be found in the toolbar when a 3D view is active.

This tool is used to set the contents of a specific 3D view to full screen. It has been implemented inside the 3D extension so it can be used for presentations and shows. This tool is the perfect complement to the stereo one since by combining both they can be used to look at 3D views in virtual reality immersive systems.

Tool Options:

Note: The full screen mode duplicates the 3D view that gvSIG is using. This causes a drop in the system performance if there is no sufficient memory and graphics hardware available.


Modo de proyección

The projection mode tool ortho can be found in the toolbar when a 3D view is active.

This tool is used to change the way in which the 3D graphics are projected (it has nothing to do with the view or layer projections). In other words, the 3D views can be projected basically in two ways: orthographic or perspective. This tool changes between these two types of projections.

Note: When the orthographic mode is active it is not possible to zoom in the view. There are only the options of panning or rotating.


Vista estereoscópica

The stereo tool stereo can be found in the toolbar when the 3D view is active.

This tool is used to activate or deactivate the stereo in the view. It is made up by the following options:


Insertar vista en el layout.

The steps to follow in order to insert a view in the layout are the following (assuming one or several 3D views):

Note: Unlike the 2D view of gvSIG, in order to adjust the 3D view in the map it is necessary to move the view itself. If the adjustment is done on the inserted view in the map, there will be no effect over the view.


Trabajo con capas en 3D

Introducción

The layers of information in the 3D views are exactly the same as in the normal views, thus the way to work with them is the same.

In the 3D extension a new layer type has been added. They are called 3D objects. These layers contain objects tridimensional modelled. Their functioning will be explained later on.


Añadir capas

The same tool “Add Layer” used in the normal views to add layers is used in the 3D views, using the same data source types. The window to select the layers to be added is exactly the same:

images/anyadir-capa-es.png

Adding layer window


Añadir capas raster

The data sources providing information of raster type are raster files and the WMS, WCS and ArcIMS Map services. The 3D views allow representing the raster data in two ways: as images (flat over the terrain surface) and as elevation (defining the terrain relief).

The 3D extension offers to the user the option to represent a raster as elevation in the following cases:

In the case that is possible to use the raster as elevation the following dialog will appear:

images/capa-elevacion-es.png

Loading option dialog of layer as elevation layer.

Only one elevation layer will accepted in each 3D view. If the user tries to add additional layers to the view the following message will appear:

images/capa-elevacion-dos-es.png

Control of additional elevation layers dialog.

At the moment gvSIG is able to reproject rasters, therefore there should not be any problem using layers with different reference systems to the view.


Añadiendo capas vectoriales

The data sources that can provide information of vector type are the vector files (SHP, DWG...), the vector databases and the WFS y ArcIMS Feature services.

The 3D views allow representing vector data in two ways: rasterised, as images glued over the terrain surface, and as three dimensional objects. The 3D extension offers the user the two options for all the mentioned data sources, although the results obtained with the ArcIMS Feature Service is not adequate for representation as 3D objects given how it draws this type of layer.

When the user adds a vector layer to the view the following dialog will show:

images/dialogo-rasterizar-es.png

Vector layer options.

When the rasterisation option is deactivated to represent the vector data as objects in 3D, the elevation values (Z component) given by the geometry of the data can be used. If this option is selected and the geometry does not contain Z values, it will default to zero. This can complicate the visualisation in 3D since the terrain surface will mask the data.

Because of that, if the vector data does not contain elevation it would be better if the user assigns an elevation value in meters using the entry field in the lower part of the dialog.

images/vectorial-rasterizada-es.png

Example: Capture of layer with rasterised polygons in Europe.

images/vectorial-es.png

Example: Capture of layer with un-rasterised polygons in Europe.


Propiedades de las capas vectoriales 3D

As it was shown in the previous section, it is necessary to indicate in which way the vector layers will be represented in the 3D view. It is possible to change the type of representation by using the 3D properties of a layer.

If we go to the TOC and right-click over the vector layer, a context menu will appear. We will select “Propiedades 3D” and the following dialog will show up:

images/dialogo-propiedades3d-es.png

If we go to "Opciones" in the “Capa vectorial” tab, we could modify the way to represent the 3D layer.

images/dialogo-propiedades3d-vectorial-es.png

In the same windows we could see there is another section “Nivel de detalle” and there are several other related options:


Creación de la caché de visualización

Once having added layers, either as images or elevation layers it should be noted that data takes some time to become visible at their maximum resolution. This happens because the 3D extension creates a multi-resolution representation of the layer in the local hard drive which is used for quick visualisation of the data at different scales. This visualisation cache is actually stored in the local folder gvSIG\.data\cache\Earth within the user’s root directory.

The first time data is visualised or when the scale or the view is changed, the cache generation process is executed automatically. The speed of the cache creation will depend on the speed to access the source (it will be much slower for remote services) and the complexity of the data (e.g., vector quantity). Once the cache is created, panning within the same area will render fast and interactive visualisation. However, if the properties of the layer are changed and they affect the existing cache, this will be recreated automatically.

There is a way to force a cache to be invalid (See the “Refresh Layer” section).


Capas de objetos 3D

Upload layers of 3D objects

The layers of 3D objects are loaded in the same way that layers are loaded for a vector or raster file.

In the dialog of add layer from file, click on the add button and under "Select file type" select GvSIG OSG Driver

The formats of 3D object layers that GvSIG can load are files of type .osg and .Ive.

To learn how to generate those formats refer to the section Create layers of 3D objects and Save layers of 3D objects.

Create layers of 3D objects

The tool to create 3D object layer create layer can be found on the toolbar when a 3D view is active.

When you click on the create 3D layer button, a new layer of vector type is created immediately and a message appears indicating that the layer has been automatically set to editing mode.

Save layers of 3D objects

The tool to save layers with 3D objects save object can be found in the toolbar when you select a 3D objects layer in a 3D view and is also it activates the editing mode of that layer.

If we click on it you will get the following dialog box, where we can select the path and file format (*.osg or *.ive) in which we want to save the layer.

./images/dialogo-salvar-capa-edicion-es.png

Note: The file format *.osg is an ASCII type while the file format *.ive is a binary type.


Edición de capas de objetos 3D

Enabling/disabling editing of 3D object layers

To enable/disable editing of 3D object layers simply click on the selected layer and right-click on it. In the context menu select Enable 3D editing, if you want to activate the 3D edition or Off 3D editing, if you want to disable the 3D edition.

images/activar-desactivar-edicion-es.png

Insert 3D objects

The tool to insert 3D objects insertar can be found in the toolbar when you select a 3D objects layer from a 3D view and also the active layer is in editing mode.

If you click on it you will see the following dialog box:

images/dialogo-importar-objeto-osg-es.png

Where each item means:

Insertion using the mouse: Once you open a dialog to insert 3D objects, if you click on the 3D view the fields of latitude, longitude and height are automatically filled in order to visually place the 3D objects.

Manipulating 3D Objects

To manipulate 3D objects is necessary to enable the editing of 3D layers and have selected the layer to be manipulated.

Types of manipulators:

images/manipulador-caja-es.png

Icon on the toolbar.

images/manipulador-caja-captura-es.png
images/manipulador-rotacion-es.png

Icon on the toolbar.

images/manipulador-rotacion-captura-es.png

Tabla de contenidos

The Table of Contents (TOC for short) included in the 3D view behaves exactly like the TOC of the 2D view, showing the layers added to the view and legend.

As in the 2D view, you can use the TOC to easily change layer visibility. In the case of the elevation layer, if this is made not visible the elevation will disappear from view, leaving surface with no relief.

Another feature of the TOC is to control the display order of the layers (which are visible over the others). That is achieved by dragging the layers up or down. In the 3D view this order applies only to the vector or raster image layers, but does not affect the layers of 3D objects or elevation layer. The following example shows how the order affects two vector raster layers but has no effect on the elevation layer.

images/toc-es.png

TOC and corresponding 3D view


El menú de contexto de las capas

In the 3D view TOC layers have a context menu practically the same as the normal view, with some additional tools. We will discuss the most relevant options.

images/menu-contexto-capa-es.png

Edición de propiedades

Using the context menu you can change the name of the layer, color (in the case of a vector layer with single symbol) and edit its properties window. In the case of changing certain properties, like the legend, the display cache is re-calculated layer, usually automatically. The figure shows the appearance of a polygon layer used in previous examples, after changing his legend to unique values.

images/leyenda-poligonos-es.png

The properties of symbols are applied to layers represented as images in the same way as would apply in a 2D view (eg the thickness and style of the lines).

images/leyenda-lineas-es.png

Moreover, in the case of vector data represented as 3D objects, the application of the symbology is limited to the size of dots and lines, and color of symbols.

images/leyenda-puntos-es.png

Note: A new type of legend called extrusion and a new kind of symbol for 3D points have been created. Look in the Extrusion and 3D Symbology sections.


Cacheado de la leyenda

In the cache for rasterized vector layers, the legend is also saved in .xml. When the same vector data source is added back as a layer, this legend is assigned by default, allowing for the reuse of the cached images. If the legend changes (see above), the cache is rebuilt and the new .xml file is saved.


Simbologia 3D

Using the power of the new symbology framework. The 3D plugin has added the possibility of inserting a new symbology for points. Specifically, we can generate a 3D Object type symbol and insert it as a symbol in a 3D layer-type vector point.

To do this open the "Symbol Properties Editor (see the manual gvSIG version 1.9-Alpha or later). In the panel for "Properties" we will deploy the list and select where it says Object 3D symbol and a panel will appear as shown below:

images/panel-simbolo-punto3d-es.png

And where the boxes mean:

Then add the new model and delete the one given by default and it would show as follows:

images/objeto3d-es.png

And the result would be.

images/mercados-modelo-es.png

Extrusión

Extrusion is a new kind of legend that has been created in the 3D plugin. This legend is used to extrude any primitive type (points, lines and polygons) that contains a vector layer in function of a given multiplication value.

A more technical definition of extrusion is:

Generating an object of dimension n+1 by the extension of a object dimension along a defined range in an additional dimension.

To use this new type of legend we have chosen to display as 3D vectors the layer that has been inserted in the 3D view.

Open the legend window and select where it says Extrusion. This window looks much like the legend of unique values. The following screen appears.

images/dialogo-extrusion-es.png

Choose the field on which you want to extrude and the extrusion level you want to apply. Click on the button to add all and accept.

images/extrusion-poligonos-es.png

Extruding polygons.

images/extrusion-lineas-es.png

Extruding lines.

images/extrusion-puntos-es.png

Extruding points.


Etiquetado

Labeling should be consistent whether the vector layer is rasterized or not. When the layer is rasterized, the labels are too. Its size and color is given by the tagging options, like in the 2D view.

images/vectorial-rasterizada-etiquetas-es.png

On the other hand, when the vector layer is not rasterized, the labels will appear as floating text with the corresponding 3D objects for the data. Their size and color is again given by the tagging options.

images/vectorial-etiquetas-es.png

Note: Only basic labeling is available in the 3D plugin.


Transparencia

In the context menu of the layers there is an option to change the transparency of an image layer (or rasterised vectors) interactively. This option can be activated from the toolbar and also from the Layer menu.

images/barra-transparencia-es.png

Icon on the toolbar.

images/transparencia-es.png

Example of extension of transparency and results.

When the tool is activated, a dialog appears with a scroll bar that lets you change the layer transparency interactively. It must be said that the interactive transparency tool has its impact over the transparency display of raster layers.


Propiedades específicas

Raster type layers and layers of remote services have specific properties that are active in the context menu. In the 3D view these menu options can be used to open the same windows of properties displayed in the layers of normal view.


Refrescar capa

From the context menu of the layer the display cache can be manually refreshed. This may be necessary for:


Zoom a la capa

This command works the same as in the normal view. The 3D view will change to show the full extent of the layer. In the spherical view, for very extensive layers it will display the full planetary globe.


Copiar, cortar y pegar capas

With the context menu sections of a 3D view can be cut or copy and paste into another normal view or 3D view. Conversely, sections can also be cut or copy from a normal view to be pasted in the 3D view.

When a layer is pasted from a 2D to 3D, the user will be able to choose the same options (elevation or image, rasterization of vectors) that if the layer were added directly from the data source.


Trabajando con Tablas

As in the 2D views, the tool 'View Table of Attributes' is available for vector layers on the toolbar and in the Layer menu. When using this tool it will show the attribute table of the active layer and will be possible to perform all the tasks, as sort fields, etc..

Records can be selected in the table manually, apply filters, etc.. The tool 'Zoom to Selected' can be used as in 2D to quickly find the records selected in the view. Also the tool 'Delete Selection' works as in normal view.

images/tablas-es.png

Herramienta de información

Like many of the tools available to the 2D, the information tool has been adapted to be used in the 3D plugin and it works just like in the version for 2D views. To access from the toolbar press the button:

images/barra-informacion-es.png

Information button.

or from the bar menu "View / Search / Information.

To obtain information about each of the elements of the map the "Information Tool" is used.

When you click on any element with this tool, gvSIG shows, in a dialog box, the attributes of that element. For that to function the layer in which the feature you want to identify has to be activated in the TOC

images/captura-informacion-es.png

Herramienta de selección en vista

The selection tool in view has been adapted to be used in the 3D view. It works for raster layers as well as for those that are not.

images/barra-seleccion-es.png

Selection options.

images/captura-seleccion-es.png

Selected area in yellow.


Servicios de búsqueda remota

Introducción

The search tools for the geodata remote catalogue and search for place names have been activated and adapted to operate in the 3D view.


Búsqueda en catálogo de geodatos

This tool appears when the 3D view is activated. It works the same way as in the 2D view, allowing search by keyword, displaying a panel with the results and allowing the user add the layer if it is defined in the catalogue. The following figure summarizes the steps taken to add a remote WMS layer from the list of FAO.

images/catalogo-es.png

Similarly you can add layers WCS and WFS, to which the coordinate system of the layer will be assigned, as long it is supported by the service. Note that on adding a layer WFS, the user will be prompted whether or not to rasterize the layer, as occurs when adding any vector layer.

Added improvement in the 3D plugin is that when you press the button to add a WMS service as a layer from catalogue search, it will open the properties window of the remote service WMS, which will allow you to select properties such as style, format and reference coordinate system. This last step is important so that the layer will display properly in 3D.


Búsqueda de topónimos

The search tool for placenames also appears when the 3D view is activated and works similarly as in the normal view. In the three-dimensional case, as the user press the button 'Locate' a flag is added to the view that indicates the coordinates of the name searched, along with a textbox displaying the name.

images/nomenclator-es.png

Animación

Introducción

En esta sección se realiza una descripción de las funcionalidades añadidas para la creación de animaciones para vistas 2D como para vistas 3D.

Resumen de funcionalidades

Partiendo de la creación de un nuevo documento, llamado documento de animación, que se añade al gestor de documentos al instalar la extensión, se puede acceder a un conjunto de herramientas para la creación de animaciones.


Documento de animación

Introducción

La extensión de 3D añade un nuevo tipo de documento llamado Animación, a través de él se accederá a la opciones de creación de animaciones tanto en vistas 2D como en 3D.


Crear un documento de animación

En el Gestor de Proyectos de gvSIG puede apreciarse la existencia de un nuevo tipo de documento llamado Animación. Todas las opciones del Gestor del Proyectos pueden aplicarse a este tipo de documento: crear un documento nuevo, abrirlo, renombrarlo, borrarlo y mostrar sus propiedades. Para crear un nuevo documento de animación se debe de pulsar la opción “Nuevo”.

images/documentos3d-es.png

Gestor de proyectos.

Gestor de proyectos con la opción de nuevo documento de animación incluida.

Abrir un documento de animación

Para abrir el documento de animación, haga doble clic sobre el nombre del documento, o pulse sobre el boton "Abrir" y se mostrarán las siguientes opciones para la creación de animaciones:

images/documento-animacion-es.png

Herramientas iniciales para la creación de una animación.


Herramientas de captura de vistas

A continuación se enumeran el conjunto de controles de un documento de animación relacionadas con la captura de encuadres en una vista.

images/captura-posicion-es.png

Botón de captura de encuadres.

Mediante el pulsado de este botón se produce la captura de la posición concreta en la vista (x,y,z). Para la realización de una animación de movimiento, se tomarán las muestras (posiciones en este caso) que sean necesarias, cuanto mas elaborada sea una animación (medida por el número de muestras escogidas y distancia entre ellas), el movimiento será más preciso y suave. La vista se moverá entre dos encuadres consecutivos.

images/selector-vistas-es.png

Vistas activas.

El selector de vistas incluye todas las vistas ya sean 2D como 3D abiertas en un momento dado, cualquiera de las cuales una vez seleccionada será la vista a la que se le aplicará una animación concreta (ya sea tomando fotogramas clave o aplicándole transparencia).

El selector de vista se irá actualizando con el conjunto de vistas abiertas. Una vista abierta es considerada como una vista lista para poder ser animada. Al seleccionar una vista cualquiera la vista se actualiza en el selector.

Una vista asociada a un documento de animación no puede ser asociada a otro, si no es liberada antes mediante la opción Borrar animación.

images/borrar-es.png

Botón de borrado.

Borra la animación de movimiento relacionada con un documento de animación concreto, liberando las vistas para poder ser usadas en otras animaciones.(NOTA: borra el conjunto de animaciones totales contenidas en el documento de animación).


Herramientas de captura de capas

A continuación se enumeran el conjunto de controles de un documento de animación relacionadas con la captura de encuadres en una vista.

images/animacion-automatica-es.png

Botón de animación de transparencias.

Mediante el uso de este botón se genera una animación automática de transparencias. Aplicación de transparencia a las capas seleccionadas en el TOC, en orden desde su nivel actual de transparencia a una transparencia total, una a una.

images/borrar-es.png

Botón de borrado.

Borra la animación de transparencia relacionada con un documento de animación concreto, liberando las vistas para poder ser usadas en otras animaciones.(NOTA: borra el conjunto de animaciones totales contenidas en el documento de animación).


Controles de reproducción

Despliegue del reproductor:

El pulsado de este botón abre las opciones del reproductor de la animación.

images/reproductor-es.png

Botón de despliegue.

Vista general de las opciones de animación con el reproductor desplegado.

images/opciones-total-es.png

Player desplegado.

NOTA: La frecuencia de refresco del temporizador del reproductor está fijada a 30 frames por segundo.


Animaciones en vistas 2D

Un documento de animación es capaz de animar varias vistas 2D a la vez, tanto animación de vista como de capas por separado aplicando los dos tipos de animación a la vez en una misma vista.

Una vista incluida en un documento de animación no puede ser incluida en otro documento de animación.

Una vista 2D puede ser animada conjuntamente con vistas 3D al mismo tiempo.

NOTA: El método de dibujado en la parte 2D produce un efecto Blinking o parpadeo en la pantalla, que hace que el resultado de las animaciones no sea eficiente por el momento.


Animaciones en vistas 3D

Un documento de animación es capaz de animar varias vistas 3D a la vez, tanto animación de vista como de capas por separado aplicando los dos tipos de animación a la vez en una misma vista.

Una vista incluida en un documento de animación no puede ser incluida en otro documento de animación.

Una vista 3D puede ser animada conjuntamente con vistas 2D al mismo tiempo.


Cached time 11/21/13 14:44:45 Clear cache and reload